home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / ab20_archive / datacomm / xpr / xprkermit-1.111.lzh / aaaread.me next >
Text File  |  1991-03-10  |  3KB  |  85 lines
  1. You have just unpacked the official archive of XPR Kermit, Version 1.91.
  2. The following files are included:
  3.  
  4.     #?.c, #?.h, kermitproto.w:    The source code
  5.     xprkermit.doc:            The full documentation
  6.     Makefile:            Makefile for Manx Aztec C 5.0d
  7.     options.lnt:            An options file for Gimpel
  8.                     FlexeLint, V4.00g (see below)
  9.     kermitproto.doc:        Documentation for the kermitproto.w
  10.                     file
  11.     wart:                Executable for the Wart preprocessor.
  12.     xprkermit.library:        The library itself.
  13.  
  14. Building from source
  15. --------------------
  16.  
  17. You'll need a precompiled header file for functions.h--this isn't
  18. required, but makes compiling a lot faster.  Just cc to the directory
  19. containing functions.h and execute the command
  20.  
  21. cc -ho functions.sym.16 -p0ls -a functions.h
  22.  
  23. Then, type "make".  The wart program is the executable for the standard
  24. Wart preprocessor from the Columbia University C Kermit distribution.
  25. Source is widely available, as the file "ckwart.c".  Wart compiles with
  26. either of the commercial Amiga C compilers with the symbol AMIGA
  27. #define'd.  "make archive" creates the lharc file.  "make clean" gets rid
  28. of the object files. 
  29.  
  30. Lint
  31. ----
  32.  
  33. The file "options.lnt" contains the options I used to check the source
  34. using Gimpel FlexeLint Version 4.00g.  Use of these switches (and the
  35. special /*lint format comments in the source) results in zero lint
  36. messages for the individual modules.  All together, kermitproto.c and
  37. timer.c generate some "Vacuous type" errors, and Lint warns that the
  38. assembly language routines myInit and the callbacks (calla, calld,  and
  39. so on) aren't defined.  Harmless.
  40.  
  41. Changes from Version 1.5
  42. ------------------------
  43.  
  44. This is a maintenance release of XPR Kermit.  No new features have been
  45. added, though the code has been streamlined and performance improved by
  46. use of some ideas and code from C Kermit, Version 5A.  Several major
  47. bugs were fixed:
  48.  
  49. 1.  Fixed a buffer overflow which resulted in crashes on A3000 machines. 
  50.  
  51. 2.  File I/O made much more efficient by adding local buffers in
  52. kermitproto.w.  Previously, a call to the callback routines was made for
  53. every character. 
  54.  
  55. 3.  Handling of timeouts on reads was improved...I hope. 
  56.  
  57. 4.  Block check type 2 now works correctly.  Would you believe a missing
  58. "break" at the end of a case statement? 
  59.  
  60. 5.  The file character count didn't include nulls, so it was incorrect
  61. for binary files containing them.
  62.  
  63. 6.  A potential crash source involving FreeMem() on four fewer bytes than
  64. AllocMem() was called with was fixed.
  65.  
  66. 7.  Smart transfer abort code repaired, which now co-operates with VLT,
  67. at least.  "Cancel File" will cancel only one file of a multi-file
  68. transfer, "Cancel All" is a no-holds-barred immediate abort.
  69.  
  70. 8.  Added the Keep Incomplete Files option.
  71.  
  72. 9.  Switched to Aztec C 5.0 and the "standard" sharable library interface
  73. code which is the files libstart.asm and libsup.c on the 5.0a distribution
  74. disk 4, in the res_lib directory.
  75.  
  76. 10.The code is now more immune to garbage characters which arrive
  77.    between packets.
  78.  
  79. 11.The file status display no longer starts out by showing the byte
  80.    count from the last transfer.
  81.  
  82. 12.The code uses the amicall pragma of Aztec C 5.0 to avoid the need
  83.    for assembly language glue routines for XPR Kermit itself.  The
  84.    callbacks still require them, alas.
  85.